---

Road Map to QuickTime 4

Tween Components and Native Tween Types

This chapter describes the components that perform tween operations, sometimes called tweeners. It also describes tween operations performed by QuickTime for tween types that are native to QuickTime.

A tween operation lets you algorithmically generate an output value for any point in a time interval. The input for a tween is a small number of values, often as few as one or two, from which a range of values can be derived. You can use output from a tween to modify tracks in a QuickTime movie, as described in Media Handlers: Tween.

You can also use the output values from tweeners in your application to perform actions unrelated to movies.

QuickTime 4 Reference introduces tweens and their uses and provides an overview of the tween operations that are possible.

• Tween Types
• Single Tweens and Tween Sequences
• Interpolation Tweens

QuickTime 4 Reference describes how to create the tween containers that the tween media handler uses. Several utility routines are documented.

• Utility Routines
• AddTweenAtom
• AddDataAtom
• AddSequenceTweenAtom
• AddSequenceElement
• CreateSampleAtomListTweenData
• Creating a Single Tween Container
• Using a List Tween Component
• Using a Polygon Tween Component
• Using Path Tween Components
• CreateSampleVectorData Utility
• CreateSamplePathTweenContainer Utility
• Using a kTweenTypePathToMatrixTranslation Tween Component
• Using a kTweenTypePathToFixedPoint Tween Component
• Using a kTweenTypePathToMatrixRotation Tween Component
• Using a kTweenTypePathToMatrixTranslationAndRotation Tween Component
• Using a kTweenTypePathXtoY Tween Component
• Using a kTweenTypePathYtoX Tween Component
• Specifying an Offset for a Tween Operation
• Specifying a Duration for a Tween
• Creating a Tween Sequence
• Creating an Interpolation Tween
• Naming Tweens

QuickTime 4 Reference explains how to create a tween component for a new data type, a new interpolation algorithm, or both.

• Initializing the Tween Component
• Generating Tween Media Values
• Resetting a Tween Component

QuickTime 4 Reference describes the syntax used by the various tween container types.

QuickTime 4 Reference describes the tween types that are processed by QuickTime as native types and do not require a tween component.

• kTweenTypeFixed
• kTweenTypeFixedPoint
• kTweenTypeGraphicsModeWithRGBColor
• kTweenTypeLong
• kTweenTypeMatrix
• kTweenTypePoint
• kTweenTypeQDRect
• kTweenTypeQDRegion
• kTweenTypeQTFloatDouble
• kTweenTypeQTFloatSingle
• kTweenTypeRGBColor
• kTweenTypeShort

QuickTime 4 Reference lists the tween types and their associated data structures for QuickDraw 3D objects.

QuickTime 4 Reference describes several tween components provided with QuickTime. These tween components perform complex tweening on common data types.

• List Tweener Components
• Multimatrix Tweener Component
• Path Tweener Components
• Polygon Tweener Component
• Spin Tweener Component

QuickTime 4 Reference defines the constants used with tween components. Included are a variety of tween atom types, as well as the flags used to control tween components.

• Tween Component Constant
• Tween Type and Tween Component Subtype Constants
• Tween Atom Constants
• Tween Flags

QuickTime 4 Reference defines the data types used with tween components. Included is the value setting function, which is implemented as a universal proc pointer or a universal data pointer, depending on the operating system.

• Tween QT Atom Container
• Tween Sequence Entry Record
• Component Instance
• Tween Record
• Value Setting Function

QuickTime 4 Reference defines the required functions that a tween component must support.

• Functions of All Tween Components
• TweenerInitialize
• TweenerReset
• TweenerDoTween